home *** CD-ROM | disk | FTP | other *** search
/ Suzy B Software 2 / Suzy B Software CD-ROM 2 (1994).iso / new_file / utilitys / deskcloc / deskcloc.doc < prev    next >
Encoding:
Text File  |  1995-04-25  |  2.7 KB  |  72 lines
  1. Documentation for DeskClock 1.0
  2. by Yanick Dufresne
  3. Email: y.dufresne@genie.geis.com
  4.  
  5. Distribution files:
  6.  
  7. DESKCLOC.ACC/PRG    the actual thing
  8. DESKCLOC.C            Pure C source file
  9. DESKCLOC.PRJ        Pure C project file
  10. DESKCLOC.DOC        this documentation
  11.  
  12.  
  13. Please feel free to distribute DeskClock to anyone, as long as all the 
  14. files remain together, including this DOC file.
  15.  
  16. Disclaimer: Use this software at your own risk. It has been tested on 
  17. several computers with several TOS versions and with Geneva. At the time 
  18. I'm writing this, there is no known bug but this doesn't mean there aren't 
  19. any... I make no waranty whatsoever on the working of DeskClock.
  20.  
  21. I would nevertheless appreciate any comment you may have about it.
  22.  
  23.  
  24.  
  25. Now, how does it work? Simple:  On any Atari system using AES prior to 
  26. 4.0, place the DESKCLOC.ACC in your boot drive. This will normally be 
  27. drive C:\ for hard disk users and A:\ for floppy users. You can also place 
  28. it in your ACCS\ folder if you're using a TSR to allow loading of 
  29. accessories from a separate folder.
  30.  
  31. If you're using a version of AES of 4.0 or greater, you can use the clock 
  32. as a PRG, in a multitasking environment. (rename the file as necessary) Do 
  33. not try to put it in your AUTO folder, DeskClock is a GEM application! Add 
  34. this line to your GEM.CNF file:
  35.  
  36. run z:\path\deskcloc.prg
  37.  
  38. where z:\path\ is the actual path of the program.
  39.  
  40. Note that you can still use it as an ACC. The reason you might want to 
  41. use DeskClock as a PRG is if you use tear off menus in Geneva or another 
  42. AES environment allowing it. In this case, DeskClock will issue a 
  43. menu_register() everytime the clock updates to provoque a redraw of the 
  44. tear offs. This is only possible with PRGs.
  45.  
  46. Note: DeskClock does NOT look if it's running on AES 4.0 before issuing the 
  47. call. If you try to run it as a PRG under older systems, you will very 
  48. likely get a system crash.
  49.  
  50. If you click on the menu entry, you will get an information alert.
  51.  
  52. Note 2: DeskClock checks the time every two seconds, but only updates the 
  53. menu entry everytime the minutes change. This means you might get as much 
  54. as a two second delay between DeskClock and the actual system time. This 
  55. was done to keep system usage to a minimum.
  56.  
  57. The program/accessory sources are included. They are there as a learning 
  58. too and to allow anyone interested to modify the code for their own use. 
  59. I'm not really proud of it and it's not as neatly formatted as I'd like 
  60. but this was a learning project. If it can be of use to anyone...
  61.  
  62. ALP!
  63.  
  64. Yanick Dufresne
  65. Creations Graphiqu'Art Enr.
  66. 1027, Ste-Ursule St.
  67. Trois-Rivieres, QUE, Canada  G9A 1P2
  68. Work phone: (819) 373-6946
  69. Email: y.dufresne@genie.geis.com
  70.  
  71.  
  72. ===end===